home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / mpadmin.z / mpadmin
Encoding:
Text File  |  2002-10-03  |  11.9 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmppppaaaaddddmmmmiiiinnnn((((1111))))                                                          mmmmppppaaaaddddmmmmiiiinnnn((((1111))))
  71.  
  72.  
  73.  
  74. NNNNAAAAMMMMEEEE
  75.      mpadmin - control and report processor status
  76.  
  77. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  78.      mmmmppppaaaaddddmmmmiiiinnnn ----nnnn
  79.  
  80.      mmmmppppaaaaddddmmmmiiiinnnn ----uuuu[processor]
  81.  
  82.      mmmmppppaaaaddddmmmmiiiinnnn ----rrrr[processor]
  83.  
  84.      mmmmppppaaaaddddmmmmiiiinnnn ----cccc[processor]
  85.  
  86.      mmmmppppaaaaddddmmmmiiiinnnn ----ffff[processor]
  87.  
  88.      mmmmppppaaaaddddmmmmiiiinnnn ----IIII[processor]
  89.  
  90.      mmmmppppaaaaddddmmmmiiiinnnn ----UUUU[processor]
  91.  
  92.      mmmmppppaaaaddddmmmmiiiinnnn ----DDDD[processor]
  93.  
  94.      mmmmppppaaaaddddmmmmiiiinnnn ----CCCC[processor]
  95.  
  96.      mmmmppppaaaaddddmmmmiiiinnnn ----pppp[processor]
  97.  
  98.      mmmmppppaaaaddddmmmmiiiinnnn ----wwww[processor]
  99.  
  100.      mmmmppppaaaaddddmmmmiiiinnnn ----xxxx[processor]
  101.  
  102.      mmmmppppaaaaddddmmmmiiiinnnn ----yyyy[processor]
  103.  
  104.      mmmmppppaaaaddddmmmmiiiinnnn ----NNNN
  105.  
  106.      mmmmppppaaaaddddmmmmiiiinnnn ----ssss
  107.  
  108. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  109.      _m_p_a_d_m_i_n provides control over and information about processor status.
  110.  
  111.      Exactly one argument is accepted by _m_p_a_d_m_i_n at each invocation.  The
  112.      following arguments are accepted:
  113.  
  114.      ----nnnn           Report which processors are physically configured.  The
  115.                   numbers of the physically configured processors are written
  116.                   to the standard output, one processor number per line.
  117.                   Processors are numbered beginning from 0.
  118.  
  119.      ----uuuu[_p_r_o_c_e_s_s_o_r]
  120.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  121.                   processors that are available to schedule unrestricted
  122.                   processes are written to the standard output.  Otherwise,
  123.                   _m_p_a_d_m_i_n enables the processor number _p_r_o_c_e_s_s_o_r to run any
  124.                   unrestricted processes.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmppppaaaaddddmmmmiiiinnnn((((1111))))                                                          mmmmppppaaaaddddmmmmiiiinnnn((((1111))))
  137.  
  138.  
  139.  
  140.      ----rrrr[_p_r_o_c_e_s_s_o_r]
  141.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  142.                   processors that are restricted from running any processes
  143.                   (except those assigned via the _s_y_s_m_p(MP_MUSTRUN) function,
  144.                   the _r_u_n_o_n(1) command, or because of hardware necessity) are
  145.                   written to the standard output.  Otherwise, _m_p_a_d_m_i_n
  146.                   restricts the processor numbered _p_r_o_c_e_s_s_o_r.
  147.  
  148.      ----cccc[_p_r_o_c_e_s_s_o_r]
  149.                   When no _p_r_o_c_e_s_s_o_r is specified, the number of the processor
  150.                   that handles the operating system software clock is written
  151.                   to the standard output.  Otherwise, operating system
  152.                   software clock handling is moved to the processor numbered
  153.                   _p_r_o_c_e_s_s_o_r.  Operating system software clock handling cannot
  154.                   be assigned to a processor that has been excluded via the -x
  155.                   option nor to a processor that has timeouts warded off via
  156.                   the -w option.  See _t_i_m_e_r_s(5) for more details.
  157.  
  158.      ----ffff[_p_r_o_c_e_s_s_o_r]
  159.                   When no _p_r_o_c_e_s_s_o_r is specified, the number of the processor
  160.                   that handles the operating system fast clock is written to
  161.                   the standard output.  Otherwise, operating system fast clock
  162.                   handling is moved to the processor numbered _p_r_o_c_e_s_s_o_r.  Fast
  163.                   clock handling cannot be assigned to a processor that has
  164.                   been excluded via the -x option.  See _f_t_i_m_e_r(1) and
  165.                   _t_i_m_e_r_s(5) for a description of the fast clock usage.
  166.  
  167.      ----IIII[_p_r_o_c_e_s_s_o_r]
  168.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  169.                   processors that are isolated are written to the standard
  170.                   output.  Otherwise, _m_p_a_d_m_i_n isolates the processor numbered
  171.                   _p_r_o_c_e_s_s_o_r.  An isolated processor is restricted as by the -r
  172.                   argument.  In addition, instruction cache and Translation
  173.                   Lookaside Buffer synchronization are blocked, and
  174.                   synchronization is delayed until a system service is
  175.                   requested.
  176.  
  177.      ----UUUU[_p_r_o_c_e_s_s_o_r]
  178.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  179.                   processors that are not isolated are written to the standard
  180.                   output.  Otherwise, _m_p_a_d_m_i_n unisolates the processor
  181.                   numbered _p_r_o_c_e_s_s_o_r.
  182.  
  183.      ----DDDD[_p_r_o_c_e_s_s_o_r]
  184.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  185.                   processors that are not running the clock scheduler are
  186.                   written to the standard output.  Otherwise, _m_p_a_d_m_i_n disables
  187.                   the clock scheduler on the processor numbered _p_r_o_c_e_s_s_o_r.
  188.                   This makes that processor nonpreemptive, so that normal IRIX
  189.                   process time slicing is no longer enforced.  Processes that
  190.                   run on a non-preemptive processor are not preempted because
  191.                   of timer interrupts.  They are preempted only when
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. mmmmppppaaaaddddmmmmiiiinnnn((((1111))))                                                          mmmmppppaaaaddddmmmmiiiinnnn((((1111))))
  203.  
  204.  
  205.  
  206.                   requesting a system service that causes them to wait, or
  207.                   that makes a higher-priority process runnable (for example,
  208.                   posting a semaphore).  This command also wards off Real-Time
  209.                   Clock interrupts from timeouts and interval timers to other
  210.                   processors.
  211.  
  212.      ----CCCC[_p_r_o_c_e_s_s_o_r]
  213.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  214.                   processors that are running the clock scheduler are written
  215.                   to the standard output.  Otherwise, _m_p_a_d_m_i_n enables the
  216.                   clock scheduler on the processor numbered _p_r_o_c_e_s_s_o_r.
  217.                   Processes on a preemptive processor can be preempted at the
  218.                   end of their time slice.  This command also permits RTC
  219.                   interrupts to be handled.
  220.  
  221.      ----pppp[_p_r_o_c_e_s_s_o_r]
  222.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  223.                   processors that are permitted to use the Real-Time Clock
  224.                   (RTC) for timeouts and interval timers are written to the
  225.                   standard output.  Otherwise _m_p_a_d_m_i_n permits the RTC to be
  226.                   used on the processor numbered _p_r_o_c_e_s_s_o_r.
  227.  
  228.      ----wwww[_p_r_o_c_e_s_s_o_r]
  229.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  230.                   processors that have warded off use of the RTC for timeouts
  231.                   and interval timers to other processors are written to the
  232.                   standard output.  Otherwise _m_p_a_d_m_i_n wards off their usage
  233.                   from the processor numbered _p_r_o_c_e_s_s_o_r.  Timeouts created by
  234.                   threads running on _p_r_o_c_e_s_s_o_r are queued to other processors.
  235.  
  236.      ----xxxx[_p_r_o_c_e_s_s_o_r]
  237.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  238.                   processors that are excluded are written to the standard
  239.                   output.  Otherwise, _m_p_a_d_m_i_n excludes the processor numbered
  240.                   _p_r_o_c_e_s_s_o_r.  An excluded processor is removed from system
  241.                   usage.  Currently, the processor is isolated in the same
  242.                   manner as the -I argument.  In addition, the _r_u_n_o_n command
  243.                   and _s_y_s_m_p(MP_MUSTRUN) function are prohibited from executing
  244.                   any commands on the processor.  This request fails if there
  245.                   are any MUSTRUN processes currently running on the
  246.                   processor.
  247.  
  248.      ----yyyy[_p_r_o_c_e_s_s_o_r]
  249.                   When no _p_r_o_c_e_s_s_o_r is specified, the numbers of the
  250.                   processors that are not excluded are written to the standard
  251.                   output.  Otherwise, _m_p_a_d_m_i_n unexcludes the processor
  252.                   numbered _p_r_o_c_e_s_s_o_r.
  253.  
  254.      ----NNNN           A list of processors that are isolated from receiving
  255.                   sprayed interrupts.  The system administrator can isolate
  256.                   one or more CPUs from receiving sprayed interrupts by
  257.                   placing the NOINTR statement in the system configuration
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. mmmmppppaaaaddddmmmmiiiinnnn((((1111))))                                                          mmmmppppaaaaddddmmmmiiiinnnn((((1111))))
  269.  
  270.  
  271.  
  272.                   file, /_v_a_r/_s_y_s_g_e_n/_s_y_s_t_e_m/_i_r_i_x._s_m
  273.  
  274.      ----ssss           A summary of the unrestricted, restricted, isolated,
  275.                   excluded, preemptive and clock processor numbers is written
  276.                   to the standard output.
  277.  
  278. FFFFIIIILLLLEEEESSSS
  279.      /var/sysgen/system/irix.sm      system configuration file
  280.  
  281. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  282.      ftimer(1), runon(1), sysmp(2), timers(5).
  283.  
  284. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  285.      When an argument specifies a _p_r_o_c_e_s_s_o_r, 0 is returned on success, -1 on
  286.      failure.  Otherwise, the number of processors associated with _a_r_g_u_m_e_n_t is
  287.      returned.
  288.  
  289. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  290.      It is not possible to restrict, isolate, ward, or excluded all
  291.      processors.  Processor 0 must never be restricted, isolated, or excluded.
  292.  
  293. BBBBUUUUGGGGSSSS
  294.      Changing the clock processor may cause the system to lose a small amount
  295.      of system time.
  296.  
  297.      When a processor is not provided as an argument, mpadmin's exit value
  298.      will not exceed 255.  If more than 255 processors exist, mpadmin will
  299.      return 0.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.